IBM Books

Software User's Guide Version 3.4

Configuring and Monitoring ATM

This chapter describe the ATM interface configuration and operational commands. It includes the following sections:

Accessing the ATM Interface Configuration Process

The ATM carrier card and the 25 Mbps Charm Adapter must be in the feature slot before ATM can be configured. You must reload the device after the feature slot has the ATM carrier card/25 Mbps Charm Adapter combination in place.

Use the following procedure to access the configuration process.

  1. At the OPCON prompt, enter talk 6. (For more detail on this command, refer to "What is the OPCON Process?".) For example: 
    * talk 6
  Config>

    The CONFIG prompt (Config>) displays on the console. If the prompt does not appear when you first enter configuration, press Return again.

  2. At the CONFIG prompt, enter the list devices command to display the network interface numbers for which the device is currently configured.
  3. Record the interface numbers.

    If ATM is not specified as an interface, then execute the quick configuration process, qconfig to dynamically add the ATM interface.

  4. Enter the network command and the number of the ATM interface you want to configure. For example:

    The ATM configuration prompt (ATM Config>), is displayed.

ATM Configuration Commands

This section summarizes the ATM configuration commands. Enter the commands at the ATM config> prompt.

Table 35. ATM Configuration Command Summary
 Command   Function 
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
 Interface   Displays the ATM Interface Config> prompt from which you can list, change, or configure the ATM Interface. 
  • Add an ESI.
  • List the current configuration or list ESIs.
  • Remove an ESI.
  • Set parameters of the ATM network.
  • Enable or disable an ESI.
  • Exit
 Le-client   Displays the LE Client Config> prompt from which you can list, change, or configure the LAN Emulation Client Interface as described in "Using LAN Emulation Clients". 
  • Add a LAN Emulation Client (LEC) for a token-ring or Ethernet emulated LAN.
  • Configure a LEC by network #. This command displays the LE Config> prompt, from which you can configure a specific LAN Emulation Client (LEC).
  • List LAN Emulation Clients (LECs).
  • Remove a LAN Emulation Client (LEC).
 Virtual ATM   Displays the ATM Virtual Interface Config>  prompt from which you can list, add, or remove the ATM Virtual Interface as described in "ATM Virtual Interface Configuration Commands"
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

ATM Interface Configuration Commands

This section summarizes and then explains the commands for configuring a specific ATM interface.

Enter the commands at the ATM INTERFACE> prompt.

Table 36. ATM INTERFACE Configuration Command Summary
 Command   Function 
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
 Add   Adds an ESI. 
 List   Lists the current configuration or list ESIs. 
 Qos   Displays the ATM I/F 0 QOS Config> prompt from which you can configure Quality of Service as described in "QoS Configuration". 
 Remove   Removes an ESI. 
 Set   Sets parameters of the ATM network. 
 Disable   Disables an ESI. 
 Enable   Enables an ESI. 
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Add

Use the add command to add an ESI to your ATM configuration.

Octets 14-19 of an ATM address are the End System Identifier (ESI). Each end system attached to the same switch must use a disjoint set of ESIs. When an end system activates, it attempts to register its ESIs with its ATM switch using ILMI. The switch forces all of its registered ESIs to be unique.

Syntax:

add
esi esi-address

esi esi-address
Address of End System Identifier.

Valid Values:
Any 12 hexadecimal digits

Default Value:
none

List

Use the list command to list the configuration of this ATM device or to list the set of configured ESIs.

Syntax:

list
configuration

 
esi

configuration
Lists the ATM device configuration. For an explanation of the listed fields, see "Set".

Example: list con 

                         ATM Configuration
 
  Interface (net) number =     0
  Maximum VCC data rate Mbps   =      155
  Maximum frame size    = 9234
  Maximum number of callers =  209
  Maximum number of calls =  1024
  Maximum number of parties to a multipoint call =  512
  Maximum number of Selectors that can be configured  =  200
  UNI Version = UNI 3.0
  Packet trace = OFF

esi
Lists the ESIs in the ATM configuration.

Example: list esi 

  ATM INTERFACE> list esi
 
          ESI                Enabled
  ------------------------   -------
  000000000009                  YES
  000000000100                  YES

QoS Configuration

Use the qos-configuration command to display the ATM I/F 0 QOS Config> prompt from which you can configure Quality of Service as described in "QoS Configuration".

Syntax:

qos-configuration
 

Remove

Use the remove command to remove an ESI from your ATM configuration. All ATM components using this ESI should be reconfigured to use a different ESI. An ATM component that attempts to use a removed ESI may not activate on the next device restart.

Syntax:

remove
esi esi-address

esi esi-address
Address of End System Identifier.

Valid Values:
Any 12 hexadecimal digits

Default Value:
none

Set

Use the set command to specify ATM network parameters.

Syntax:

set
max-callers

 
max-calls

 
max-config-selectors

 
max-data-rate

 
max-frame

 
max-mp-parties

 
network-id

 
trace

 
uni-version

max-callers
Sets the maximum number of entities on the device that use the ATM interface. Each LEC , Classical IP Client, and 1483 bridge interface qualifies as a user of the ATM interface. Increasing this parameter allows more users of the interface and uses more system memory.
Valid Values:
An integer in the range 64 - 1024
Default Value:
209

Example: 

  ATM INTERFACE> set max-callers 25

max-calls
Sets the maximum number of switched virtual circuits (SVCs) that can exist on this ATM device. Every point-to-point and point-to-multipoint SVC uses system resources. This parameter helps limit the system resources reserved for signaling and switched connections. Increasing this parameter will allow more simultaneous SVCs. However, more system memory will be required to manage these connections.
Valid Values:
An integer in the range 64 - 10500
Default Value:
1024

Example: 

  ATM INTERFACE> set max-calls 500

max-config-selectors
Sets the maximum number of selectors under your specific control.

The selector is used to distinguish different users on the same end system. VCC setup requests are routed in the following hierarchical fashion: ATM switches route to the destination ATM switch using the Network Prefix, the destination ATM switch routes to the destination end system using the ESI, and the end system notifies the destination user based on the selector.

Each ESI can have up to 255 associated selectors (0x00 through 0xff). The range of selectors is partitioned into two subranges, a configured selector range and an automatically assigned selector range. The ATM interface parameter max-configured-selector gives the upper bound on the configured selector range.

The ATM components on the device have various ways of choosing a selector. Some components require you to explicitly configure a selector from the configured selector range. Other components, such as Classical IP clients, allow the selector to be automatically assigned at run-time. You do not have to choose the selector because the device does this when it activates. This selector is not guaranteed to be consistent across device restarts. Automatic selector assignment is useful only for those ATM components whose ATM address does not have to be already known by other network devices.

The relative sizes of the selector range can be modified to conform to the types and numbers of ATM users on the device.

Valid Values:
0 - 255 (0x00 - 0xFF)
Default Value:
200
Note:The selector is byte 20 of a 20-byte ATM address.

Example: 

  ATM INTERFACE> set max-config-selectors 225

max-data-rate speed
Sets the default and upper bound for VCC traffic parameters of most LANE and CIP connections. For example, this is the default PCR for best-effort VCCs initiated by LE Clients. Signaled SCRs and PCRs cannot exceed this limit. The default value should be satisfactory in most situations. An example of a situation where it is beneficial to change this value would be if the majority of the stations use 25-Mbps adapters. In this case, it may be desirable to limit the data rate on VCCs to 25 Mbps so that the lower speed stations are not overwhelmed with frames from the device. The units for this parameter are Mbps.
Valid Values:
25
 
100
 
155
Default Value:
25

Example: 

  ATM INTERFACE> set speed 25

max-frame
Sets the maximum number of octets permitted in any data frame sent or received on the ATM interface. System memory is allocated based upon this parameter. Increasing the max-frame requires more system memory, but allows processing of larger frames.

All device entities using the ATM interface must use a maximum frame size less than or equal to the max-frame-size of the ATM interface. This includes all LECs and 1483 bridge interfaces.

Valid Values:
An integer in the range 512 - 31000
Default Value:
9234

Example: 

  ATM INTERFACE> set max-frame 1000

max-mp-parties
Sets the maximum number of leaves on a point-to-multipoint connection initiated by the device. This parameter affects system memory allocation. Increasing this value is necessary if the device must set up point-to-multipoint connection(s) to a large number of destinations.
Valid Values:
An integer in the range 1 - 5000
Default Value:
512

Example: 

  ATM INTERFACE> set max-mp-parties 300

network-id
Sets the network id of the ATM interface. Multiple ATM interfaces should have the same network id if there is ATM connectivity between the interfaces.
Valid Values:
0 - 255
Default Value:
0

trace
Sets the packet tracing parameters on the interface. Packet tracing can be enabled or disabled on a range of VPI/VCI values. Common VPI/VCI values to trace are:
Valid Values:
on, off
Default Value:
off

You are prompted for the VPI/VCI range you want to trace.

Beginning VPI Valid Values:
0 - 255
Default Value:
0
Ending VPI Valid Values:
0 - 255
Default Value:
255
Beginning VCI Valid Values:
0 - 65535
Default Value:
0
Ending VCI Valid Values:
0 - 65535
Default Value:
65535

Example: 

  ATM INTERFACE> set trace on
  beginning of VPI range [0]? 0
  end of VPI range [255]? 0
  beginning of VCI range [0]? 5
  end of VCI range [65535]? 5

uni-version
Sets the User Network Interface (UNI) version used by the ATM interface with communicating with the attached ATM switch. If the UNI versions are configured on the ATM switch and ATM device interface to a specific version (not AUTO-DETECT), the UNI versions must match.

If the UNI version is configured as AUTO, the ATM device attempts to learn the UNI version to use from the switch.

In UNI AUTO-DETECT mode, if the switch does not respond to the query for UNI version, the default is UNI 3.0. If the switch responds with a value other than UNI 3.0 or UNI 3.1, the default is UNI 3.1.

Valid Values:
[UNI 3.0|UNI 3.1|AUTO-DETECT|None]
Default Value:
UNI 3.0
Note:Must be compatible with the ATM switch.

Example: 

  ATM INTERFACE> set uni-version 3.0

Enable

Use the enable command to enable an ESI in the configuration of your ATM device. The ATM interface attempts to register only enabled ESIs when it activates.

Syntax:

enable
esi esi-address

esi esi-address
Address of End System Identifiers.
Valid Values:
Any 12 hexadecimal digits
Default Value:
none

Example: enable esi 

  ATM INTERFACE> enable esi 00:00:00:00:00:09

Disable

Use the disable command to disable an ESI in the configuration. ATM components using disabled ESIs will not become active on the next device restart.

Syntax: disable
esi esi-address

esi esi-address
Address of End System Identifiers.
Valid Values:
Any 12 hexadecimal digits
Default Value:
none

Example: disable esi 

  ATM INTERFACE> disable esi 00:00:00:00:00:09

Accessing the Virtual ATM Interface Configuration Process

From the ATM Config> prompt of a selected real ATM interface, use the Virtual ATM command to enter the Virtual ATM configuration command mode.

ATM Virtual Interface Configuration Commands

This section summarizes the ATM virtual interface configuration commands. Enter the commands at the ATM virtual interface config> prompt.

Table 37. ATM Virtual Interface Configuration Command Summary
 Command   Function 
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
 Add   Adds a virtual ATM interface. 
 List   Lists the current configured virtual ATM interfaces. 
 Remove   Removes the virtual ATM interface from the current configuration. 
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Add

Use the add command to add an ATM virtual interface. A new ATM virtual interface is added to the corresponding ATM real interface (the configuration menu from which this ATM virtual interface configuration menu is accessed). The net/interface number assigned to the newly created ATM virtual interface is displayed and it is one number greater than the current largest interface number.

Syntax:

add
 

Example: 

  ATM Virtual Interface config> add
  Added ATM Virtual Interface Net as interface 5 on physical ATM interface 0
  ATM Virtual Interface config>

List

Use the list command to list configured ATM virtual interfaces defined on the current real ATM interface.

Syntax:

list
 

Example: 

  ATM Virtual Interface config> list
 
                     ATM Virtual Interface Nets
  ----------------------------------------------------------------------
    ATM interface number = 0
    ATM Virtual Interface Net interface number = 5
 
  ATM Virtual Interface config>

Remove

Use the remove command to delete an ATM virtual interface. The virtual ATM interface on the real ATM interface with the specified interface number will be removed from the SRAM configuration records. If you do not specify an interface number, the last ATM virtual interface on this real ATM interface will be deleted. If you enter a question mark (?), all ATM virtual interfaces on the current real ATM interface will be listed and you can select from that list the interface you want to remove.

Syntax:

remove
n

Example: remove 5 

  Virtual ATM 5 deleted successfully.
  ATM Virtual Interface config>

Accessing the ATM Monitoring Process

Use the following procedure to access the ATM monitoring commands. This process gives you access to an ATM's monitoring process.

  1. At the OPCON prompt, enter talk 5. (For more detail on this command, refer to "What is the OPCON Process?".) For example: 
    * talk 5
+

    The GWCON prompt (+) is displayed on the console. If the prompt does not appear when you first enter the console, press Return again.

  2. Enter interface at the + prompt to display a list of configured interfaces.
  3. Record the interface numbers.
  4. Enter network followed by the number of the ATM interface. 
       + network 1
   ATM+

    The ATM monitoring prompt (ATM+) is displayed.

ATM Monitoring Commands

This section summarizes the ATM monitoring commands for monitoring ATM interfaces. Enter the commands at the ATM+ prompt.

Table 38. ATM monitoring command Summary
 Command   Function 
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
 Interface   Displays the ATM Interface+ prompt from which you can monitor the ATM Interface, as described in "ATM Interface Monitoring Commands (ATM INTERFACE+ Prompt)". 
 Atm-llc   Displays the ATM LLC+ prompt from which you can monitor endpoints, a set of user clients, and a set of ATM channels. 
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Interface

Displays the ATM Interface+ prompt, described in "ATM Interface Monitoring Commands (ATM INTERFACE+ Prompt)".

Syntax:

interface
 

ATM-LLC

Displays the ATM-LLC+ prompt, described in "ATM-LLC Monitoring Commands".

Syntax:

atm-llc
 

ATM Interface Monitoring Commands (ATM INTERFACE+ Prompt)

This section summarizes and then explains the commands for monitoring a specific ATM interface.

Enter the commands at the ATM INTERFACE+ prompt.

Table 39. ATM INTERFACE monitoring command Summary
 Command   Function 
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
 List   Lists ATM addresses and VCCs. 
 Trace   Starts/Stops packet tracing on a specified VPI/VCI range. Trace can be viewed by ELS. 
 Wrap   Starts/Stops a loopback test on the VCC. 
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

List

Use the list command to list various categories of ATM data.

Syntax:

list
addresses

 
all

 
circuit

vccs

reserved-bandwidth

addresses
Lists the ATM addresses, along with a descriptive name, in use on the device.

Example: 

ATM INTERFACE+ list addresses
 
               ATM Address                                Name
----------------------------------------  -------------------------------------
3999999999999900009999020000041347391804  LEC 1 'eth1'
3999999999999900009999020000041347391802  LES/BUS 'eth1'

all
Lists all of the following:

circuit
Lists the statistics for a particular VCC by specifying the particular VCI-VPI pair. You can also specify the circuit on the command line; for example: list circuit 33.

Example: 

ATM INTERFACE+ list circuit
VPI [0]?
VCI [32]?33
 
     Frames transmitted   =         2  Bytes transmitted   =       216
     Frames received      =         2  Bytes received      =       216

vccs
Lists all the VCCs established by the device. The VCCs may be permanent (PVC) or switched (SVC), point-to-point or point-to-multipoint, and each is identified by a unique VPI/VCI. The trace command uses the VPI/VCI value for a VCC to perform packet tracing over a particular VCC.

Example:

P-P
point to point VCC
P-MP
point to multipoint VCC
ILMI
Interim Local Management Interface VCC
SAAL
signaling VCC
Bx-y
Internally bound VCC to VPI x, VCI y
Sx-y
Internally spliced VCC to VPI x, VCI y

reserved-bandwidth
Lists the reserved bandwidth on the ATM Interface.

Example: 

ATM INTERFACE+ list reserved-bandwidth
Line Rate                    : 155000 Kbps
Peak Reserved Bandwidth      : None
Sustained Reserved Bandwidth : None

Trace

Use the trace command activate packet tracing over a specified range of VPI/VCI values. You can view trace data by using ELS as described in "View".

Syntax:

trace
list

on

off

list
Displays the current packet tracing options on the ATM interface.

Example: 

ATM Interface+ trace
on | off | list []? list
Packet trace is ON
Range of VPIs to be traced:       0 -       0
Range of VCIs to be traced:      32 -      39

on
Starts packet tracing on all active VCCs within the specified VPI/VCI range.

Example: 

ATM Interface+ trace on
beginning of VPI range [0]?
end of VPI range [0]?
beginning of VCI range [32]?
end of VCI range [65535]? 39

off
Stops packet tracing on all VCCs.

Example: 

ATM Interface+ trace off
ATM Interface+ trace list
Packet trace is OFF

Wrap

Use the wrap command to perform a loopback data test on the ATM interface of the adapter. Wrap can be issued on a per VC basis by specifying VPI-VCI pairs. Data is looped back internally.

You can selectively start a wrap, stop a wrap, or display the current wrap settings.

If you stop or display a wrap, the following statistics will be displayed:

For display, the current wrap statistics are displayed.

For stop, the final wrap statistics are displayed.

Syntax:

wrap
display

start

stop

display
Displays the current wrap settings.

start
Starts the wrap procedure and specifies the VPI-VCI length of pattern and the pattern itself.

Example: 

ATM Interface+ wrap start
VPI [0]?
VCI [32]?
wrap pattern length [32]?
Enter 32-byte wrap pattern: [ABCDEFGHIJKLMNOPQRSTUVWXYZ123456]?

stop
Stops the wrap procedure and displays final wrap statistics.

ATM-LLC Monitoring Commands

This section explains the commands for monitoring ATM LLC multiplexing.

Enter the commands at the ATM-LLC+ prompt.

Table 40. ATM LLC Configuration Command Summary
 Command   Function 
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
 List   Lists various options 
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

List

Use the list command to list various categories of ATM LLC monitoring data.

Syntax:

list
endpoints

 
channels

endpoints
Lists the ATM addresses in use by protocols using the ATM-LLC multiplexing function on the device. The endpoint is displayed as the End System Identifier and the Selector.

Example: list endpoints 

ATM-LLC+ list endpoints

channels
Lists the channels in use by protocols using the ATM-LLC multiplexing function on the device.

Example: list channels 

ATM-LLC+ list channels

ATM Virtual Interface Monitoring Commands

Monitoring the ATM virtual interface is done using the ATM LLC monitoring commands. See "ATM-LLC Monitoring Commands" for additional information.

ATM and Virtual ATM Dynamic Reconfiguration Support

This section describes dynamic reconfiguration (DR) as it affects Talk 6 and Talk 5 commands.

CONFIG (Talk 6) Delete Interface

ATM and Virtual ATM supports the CONFIG (Talk 6) delete interface command with no restrictions.

GWCON (Talk 5) Activate Interface

ATM and Virtual ATM supports the GWCON (Talk 5) activate interface command with the following consideration:

You cannot activate an ATM base net.

All ATM and Virtual ATM interface-specific commands are supported by the GWCON (Talk 5) activate interface command.

GWCON (Talk 5) Reset Interface

ATM and Virtual ATM supports the GWCON (Talk 5) reset interface command with the following consideration:

You cannot reset an ATM base net.

All ATM and Virtual ATM interface-specific commands are supported by the GWCON (Talk 5) reset interface command.

[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]